home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / lib / include / gate.h < prev    next >
C/C++ Source or Header  |  1992-06-05  |  3KB  |  75 lines
  1. /* 
  2.  * gate.h --
  3.  *
  4.  *    Header file for users of the Gate_ functions.  These
  5.  *      functions access a database of gateways for use with
  6.  *      communicating with Sprite hosts accross those gateways.
  7.  *
  8.  * Copyright 1992 Regents of the University of California
  9.  * Permission to use, copy, modify, and distribute this
  10.  * software and its documentation for any purpose and without
  11.  * fee is hereby granted, provided that the above copyright
  12.  * notice appear in all copies.  The University of California
  13.  * makes no representations about the suitability of this
  14.  * software for any purpose.  It is provided "as is" without
  15.  * express or implied warranty.
  16.  *
  17.  * "$Header: /sprite/src/lib/include/RCS/gate.h,v 1.2 92/06/05 12:36:43 voelker Exp $"
  18.  */
  19.  
  20. #ifndef _GATE
  21. #define _GATE
  22.  
  23. #include "host.h"
  24.  
  25. /*
  26.  * A gateway information file contains listings of gateway definitions,
  27.  * one per line.  Each line has the form:
  28.  *
  29.  *     <descr> <netType> <netAddr> <inetAddr>
  30.  *
  31.  *
  32.  *      descr               One word description of the gateway.
  33.  *    netType         Type of local network by which the gateway is
  34.  *                      connected.  Currently, only `ether', `ultra',
  35.  *                      and `fddi' are understood.
  36.  *    netAddr              Address for the local network of the given type.
  37.  *    inetAddr          The internet address of the network interface
  38.  *                          of the host.
  39.  *
  40.  * When routes are installed to specific hosts on a machine, those routes
  41.  * need to know the net addresses (e.g., ethernet address) of those
  42.  * machines.  However, if the host is on another subnet, then the route
  43.  * should use the net address of the gateway to that subnet instead of
  44.  * the net address of the host.  The decision to route to the host
  45.  * directly or to a gateway is done at route installation time, based
  46.  * upon the internet address of the host.  The route installation
  47.  * routines use the gateway file to translate internet addresses of hosts
  48.  * on different subnets to net addresses to gateways to those hosts.
  49.  *
  50.  */
  51.  
  52. typedef struct Gate_Entry {
  53.     char              *desc;        /* Description of gateway */
  54.     Net_Address       netAddr;      /* Network address of the gateway */
  55.     Net_InetAddress   inetAddr;     /* Internet address mask for those network
  56.                      * interfaces that use this gateway */
  57. } Gate_Entry;
  58.  
  59. /*
  60.  * Accessor functions
  61.  */
  62. Gate_Entry *    Gate_ByInetAddr();    /* Find by Internet address */
  63. Gate_Entry *    Gate_ByDesc();        /* Find entry by name */
  64. Gate_Entry *    Gate_ByNetAddr();    /* Find by LAN address */
  65. void        Gate_End();        /* Close gate description file */
  66. Gate_Entry *    Gate_Next();        /* Retrieve next entry in file */
  67. int        Gate_SetFile();        /* Change file to read for info */
  68. int        Gate_Start();        /* Open gateway description file */
  69.  
  70.  
  71. #endif /* _GATE */
  72.  
  73.  
  74.  
  75.